package com.bookrecomm.vo;

import lombok.Data;

/**
 * 统一响应结果类
 * 用于封装API返回的数据格式
 * @param <T> 数据类型
 */
@Data
public class ResultVO<T> {

    /**
     * 状态码
     * 200: 成功
     * 400: 客户端错误
     * 401: 未授权
     * 403: 禁止访问
     * 404: 资源不存在
     * 500: 服务器错误
     */
    private Integer code;

    /**
     * 响应消息
     */
    private String message;

    /**
     * 响应数据
     */
    private T data;

    /**
     * 是否成功
     */
    private Boolean success;

    /**
     * 创建成功结果
     * @param data 数据
     * @param <T> 数据类型
     * @return 结果对象
     */
    public static <T> ResultVO<T> success(T data) {
        ResultVO<T> result = new ResultVO<>();
        result.setCode(200);
        result.setMessage("操作成功");
        result.setData(data);
        result.setSuccess(true);
        return result;
    }

    /**
     * 创建成功结果（无数据）
     * @return 结果对象
     */
    public static <T> ResultVO<T> success() {
        return success(null);
    }

    /**
     * 创建成功结果（自定义消息）
     * @param message 消息
     * @param data 数据
     * @param <T> 数据类型
     * @return 结果对象
     */
    public static <T> ResultVO<T> success(String message, T data) {
        ResultVO<T> result = new ResultVO<>();
        result.setCode(200);
        result.setMessage(message);
        result.setData(data);
        result.setSuccess(true);
        return result;
    }

    /**
     * 创建失败结果
     * @param code 状态码
     * @param message 消息
     * @return 结果对象
     */
    public static <T> ResultVO<T> error(Integer code, String message) {
        ResultVO<T> result = new ResultVO<>();
        result.setCode(code);
        result.setMessage(message);
        result.setData(null);
        result.setSuccess(false);
        return result;
    }

    /**
     * 创建客户端错误结果
     * @param message 消息
     * @return 结果对象
     */
    public static <T> ResultVO<T> clientError(String message) {
        return error(400, message);
    }

    /**
     * 创建未授权错误结果
     * @return 结果对象
     */
    public static <T> ResultVO<T> unauthorized() {
        return error(401, "未授权，请先登录");
    }

    /**
     * 创建禁止访问错误结果
     * @return 结果对象
     */
    public static <T> ResultVO<T> forbidden() {
        return error(403, "无权限访问该资源");
    }

    /**
     * 创建资源不存在错误结果
     * @return 结果对象
     */
    public static <T> ResultVO<T> notFound() {
        return error(404, "请求的资源不存在");
    }

    /**
     * 创建服务器错误结果
     * @return 结果对象
     */
    public static <T> ResultVO<T> serverError() {
        return error(500, "服务器内部错误");
    }
}
